home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1997 January / macformat-046.iso / Shareware Plus / Developers / EnterAct / EnterAct Stuff / Documentation / EnterAct Memory Needs < prev    next >
Encoding:
Text File  |  1996-09-01  |  3.8 KB  |  93 lines  |  [TEXT/KEEN]
  1. EnterAct Memory Needs Sept 96
  2. (note these have been revised slightly upwards for version 3.7)
  3. ----------------------------
  4. EnterAct ships with a default partition of 7 Meg, and this is the recommended
  5. size for regular use. If you decrease EnterAct's partition you may need to strip
  6. unneeded header files from your project to avoid running out of memory. In
  7. practise that's a real nuisance to to, so live with the 7 Meg if you can.
  8.  
  9. Bare minimum: 1024K.
  10. Small project (almost no dictionary): 2 Meg.
  11. Small-medium projects: 2-3 Meg.
  12. Many large projects: 4-6 Meg.
  13. Just about anything: 7-8 Meg.
  14. Incredibly huge hAWK programs: you should now REDUCE rather than increase
  15.     EnterAct's partition, hAWK programs now take memory from the Finder
  16.     if needs grow beyond 300K
  17.     (minimum EnterAct partition required to run hAWK is 1.4 Meg)
  18. Cross-referencing all of a medium-to-large project: everything you've got,
  19.     and cross your fingers
  20. Some details follow.
  21.  
  22. EnterAct keeps your entire project dictionary in memory, which
  23. means that large projects can need a lot of memory. This guide
  24. will help you estimate how much memory EnterAct should be
  25. given to handle a particular project.
  26.  
  27. Dictionary memory needs can be determined from the sizes of
  28. source and header files with reasonable accuracy. To find out
  29. the size of a set of files, add the files to your project, use the
  30. Find dialog or <Option>-drag in the project window to select
  31. them, and then run the hAWK program "$FileSizes".
  32.     1 System headers: memory = 1.2 times total file sizes.
  33.     2 Your headers: memory = total file sizes.
  34.     3 Source (.c) files: memory = .16 times total file sizes.
  35. Add up these three memory numbers, and then add ~1000K for
  36. basic operations to arrive at your total memory needs. If you
  37. want to run hAWK programs, add an additional 300K (200K
  38. might be enough, it depends on the program).
  39.  
  40. To view your free memory within EnterAct, select "Show
  41. Activities..." and check the number in the resulting dialog.
  42.  
  43. If total memory needs turn out to be too large, the best place to
  44. go trimming is among the system headers. There will probably
  45. be several headers that you don't need, and if you take a few
  46. minutes now to identify the ones you don't need and remove
  47. them from your project you may well find you're back in
  48. business.
  49.  
  50. Some large headers that you may not need:
  51. AppleEvents.h
  52. AppleTalk.h
  53. Errors.h
  54. Files.h
  55. Quickdraw.h
  56. Script.h
  57. Sound.h
  58. SysEqu.h (or LowMem.h or LoMem.h)
  59. Traps.h
  60. Gestalt.h
  61. --and there are many others nearly as large that you might
  62. want to omit. If you don't need it, remove it.
  63.  
  64. If you do need to strip some headers out in order to free up
  65. memory, here's the way to do it once:
  66. • make a new project, add all headers in folders of interest
  67. that you would include in all your projects (typically at
  68. least do an "Add Mac Headers")
  69. • use Remove File to remove the ones you don't want
  70. • place bullets beside all remaining file names by opening
  71. the Find dialog and clicking the "All" button
  72. • select "hAWK" from the "EnterAct" menu, use the topmost
  73. popup there to select the program named "$EchoFullpathNames"
  74. and click the Run button
  75. • use Save As on the resulting window to save the list of
  76. full path names
  77. •later, when you create a new project, first hold down the
  78. <Shift> key and select "Add Files from List..." - pick your
  79. file list in the resulting Open dialog, and your stripped-down
  80. list of headers (or any files for that matter) will be added
  81. to your project.
  82.  
  83. You can also exclude a file from being built into your dictionary
  84. by holding down the <Command> key as you click on its name in
  85. the project window. A dash '-' will appear to the left of its name,
  86. indicating that the parser will skip over it. To exclude a file name
  87. in a list of full path names, precede the name with an exclamation
  88. mark '!'. The file will still be added to your project, but with a
  89. dash beside its name.
  90.  
  91.  
  92.  
  93.